home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / gblib1 / gblib.txt < prev    next >
Encoding:
Text File  |  1994-08-30  |  1.6 KB  |  36 lines
  1. GBLIB1 was written as a companion to Visual Basic.
  2. There were 2 criteria for including a function or subroutine in the library.
  3.  
  4. Either:    1) Visual Basic was unable to do it.
  5. or     2) It saved tedious and/or complicated API declarations.
  6.  
  7. In category (1) are the SubClassing and Cursor functions.
  8. In Category (2) are the Resource and Sound functions.
  9.  
  10. As much effort went into the help file GBLIB1.HLP as the DLL itself.
  11. This is because a DLL library is only useful if the functions are understood
  12. in their syntax and use.
  13.  
  14. Each Subroutine or Function has an explanation of it's use, the original
  15. Pascal Prototype (so that it can be used with other languages) the Visual
  16. Basic Declaration, and, where appropriate, an example of how it can be used.
  17.  
  18. There were two important aims in writing the code:
  19. 1)    All routines should be 'system-resource-friendly', in that they should
  20.     return any resources they consume. (eg DCs, Handles, Objects)
  21. 2)    All routines should be as robust as possible, and capable of detecting
  22.     their own errors.
  23. Most routines check the parameters passed to them, and will return cleanly
  24. if they are bad, usually with a Message Box outlining the problem, and any
  25. resources returned.
  26. Most functions return Zero for success, and 1 for failure. (except those which
  27. retrieve a value, of course)
  28.  
  29. The DLL and associated help file are distributed as FREEWARE, under conditions
  30. outlined in the help file (See About)
  31.  
  32. The DLL was written in Borland Turbo Pascal for Windows(tm) V1.5 and the
  33. help file was written using Microsoft Word for Windows(tm) V6.0
  34.  
  35. Gordon Bamber 30/08/94
  36.